home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Games / PC-SIG World of Games (CDRM1080710) (1993).iso / 2709 / BALLOONS.DOC next >
Text File  |  1992-06-14  |  12KB  |  289 lines
  1.  
  2. This is the documentation for BALLOONS, version 3.9
  3.             (c)1990 by AssistWare
  4.                        P.O. Box 13464
  5.                        Research Triangle Park,  NC  27709-3464
  6.  
  7. DESCRIPTION:
  8.  
  9. This program draws a balloon and sounds a tone when any key is
  10. hit.  The balloons are a random size, color and are drawn at
  11. random locations on the screen.  Each key is assigned a different
  12. tone (the user can play tunes by pressing the appropriate keys).
  13.  
  14. Hitting the down-arrow key causes the balloon to shrink until it
  15. disappears.
  16.  
  17. Hitting the up-arrow key causes the balloon to grow until it
  18. pops. After the pop, a rainbow is drawn and the first phrase of
  19. "Twinkle, Twinkle Little Star" is played.
  20.  
  21. For EGA & VGA monitors, Hitting the G makes green balloons
  22.                                     B makes blue balloons
  23.                                     R makes red balloons
  24.                                     Y makes yellow balloons
  25.                                     W makes white balloons
  26.  
  27. For CGA monitors,  Hitting the Y makes yellow balloons
  28.                                G makes green balloons
  29.                                R makes red balloons
  30.  
  31. Hitting qu (short for quit) stops the program.....
  32.  
  33. If you forget, you will have to CTL-ALT-DEL to get out.
  34.  
  35. =================================================================
  36.  
  37. STARTING THE PROGRAM:
  38.  
  39. 1) Type the following on the DOS command line:  balloons
  40. 2) Press the enter key.
  41.  
  42. The DOS command line is the place where one types in the name of
  43. programs.  It often has a "command prompt" at the left side the
  44. line that looks like C:> or A:>.
  45.  
  46. ==================================================================
  47.  
  48. OTHER CONSIDERATIONS:
  49.  
  50. - If your monitor is set to 40 column mode, set it to 80 column
  51.   color mode before the program is started.
  52.   (use the DOS command:  MODE CO80).
  53.  
  54. - To allow a small child to continuously hold a key down and
  55.   the program run without overflowing the keyboard buffer, the
  56.   program discards all keys which are in the keyboard buffer
  57.   while the program is drawing a balloon.  For slow machines this
  58.   has the following implication:
  59.      The processor may not be fast enough to discard all of the
  60.      extra keys and draw the balloon at the same time. If this
  61.      occurs, you will hear the high-pitched beep that indicates
  62.      the keyboard buffer has overflowed.  Just take your hand off
  63.      of the key for an instant and the program will have time to
  64.      discard the keys in the buffer and draw the balloon.  This
  65.      problem does not occur with faster machines.
  66.  
  67. - If you have a CGA monitor, the program can only draw balloons and
  68.   rainbows in 3 different colors.  This restriction is due to the way
  69.   Turbo C and the CGA video card work together.
  70.  
  71. =================================================================
  72.  
  73. SOME PROBLEMS OTHERS HAVE ENCOUNTERED:
  74.  
  75. - Program does not work with a monochrome (single color) display.
  76.   - The program requires a color display to operate.  Color
  77.     displays are often called CGA, MCGA, EGA, EGA64, or VGA
  78.     displays. In general, if a display can display 4 or more colors
  79.     at the same time and if the display is compatible with the
  80.     IBM CGA, EGA, or VGA display, this program should work.
  81.     In addition, this program will support SVGA or XVGA displays by
  82.     running in a VGA mode.
  83.  
  84. - Program starts, then stops indicating that one of the following
  85.   problems was detected:
  86.   - "Program could not detect a graphics card in your PC."
  87.   - "Program does not support the display subsystem contained in
  88.      your PC."
  89.   - "Insufficient memory to load code which creates the graphic
  90.      images."
  91.     This is similar to the above problem.  The display must be a
  92.     CGA, EGA, VGA or correctly emulate one of these display types
  93.     for the program to operate.  "Insufficient memory" may indicate
  94.     a lack of available memory either in the PC or on the graphic
  95.     display subsystem.
  96.  
  97. - When my child hits the PRINT SCREEN key and the printer is turned
  98.   on, the printer prints "garbage".
  99.   - The PRINT SCREEN key is a special PC key that causes DOS to try
  100.     to print what is on the screen.  In the case of Balloons
  101.     there will be balloons or rainbows displayed on the screen.
  102.     The PRINT SCREEN function does not know how to tell the printer
  103.     to print balloons or rainbows but tries to anyway.  The result
  104.     is often pages of "garbage".  The solution is to turn off the
  105.     printer when using Balloons.
  106.  
  107. =================================================================
  108.  
  109. ERRORS:
  110.  
  111. If the program had an error and could not continue, try the
  112. following:
  113.  
  114. 1. Review the above list of problems that others have encountered;
  115.    the answer to your problem may be given above.
  116.  
  117. 2. Run the program again, starting it with a "starting option".
  118.    A list of starting options are given by starting the program
  119.    with a ?.
  120.    - for example:  balloons ?   (The list is also given below)
  121.    Then pick the starting option that appears to best fit your
  122.    computer's monitor.
  123.  
  124.    (A "starting option" is a way for you to tell the program how
  125.     you wish to start and run the program.)
  126.  
  127. ==================================================================
  128.  
  129. Starting options:  (i.e.  balloons option)
  130.  
  131. If no option is used, the program tries to determine which
  132. monitor your computer has and then writes directly to the video
  133. card RAM.  Writing directly to the video card RAM only works if
  134. your system's video hardware is identical to IBM display adapters.
  135.  
  136. > I suggest that you try starting the program with no starting
  137. > options:
  138. > i.e. balloons    and see if it works; use the following starting
  139. > options only if needed.
  140.  
  141. The following table shows the valid starting options.  You may wish
  142. to use these if the program is unable to determine which monitor
  143. your computer has.
  144.  
  145.                           | write directly |     use DOS
  146.          Monitor          |  to video card | video interface
  147.  -------------------------+----------------+-----------------
  148.     CGA                   |     CGAD       |       CGA
  149.     VGA                   |     VGAD       |       VGA
  150.     EGA (high resolution) |     EGAD       |       EGA
  151.     Let program decide    |                |       DOS
  152.  
  153. Examples: - Start program for a CGA monitor writing directly to
  154.             the video card:  balloons  CGAD
  155.           - Start program and let program decide the best choice
  156.             and use the DOS video interface:  balloons  DOS
  157.           - Start program and let program decide the best choice
  158.             and write directly to the video card:  balloons
  159. ==================================================================
  160.  
  161. 3. If you still have problems, send the following information
  162.    to:  AssistWare,
  163.         Atten. Balloon's Problem
  164.         P.O. Box 13464,
  165.         Research Triangle Park, NC  27709-3464
  166.    a. The type of computer you have.
  167.    b. The type of monitor you have.
  168.    c. The DOS version you are using.
  169.    d. The program version.
  170.    e. The program error number and a description of your problem.
  171.  
  172.    We will make a good-faith effort to fix your problem.
  173.  
  174. =================================================================
  175.  
  176. MY CHILD'S EXPERIENCE:
  177.  
  178. This program was written for my son, Charles, who wanted to work
  179. on the computer (hit on the keyboard), because he saw his parents
  180. doing this. However, he was too young mentally and did not have
  181. the fine motor skills necessary for programs that show A when "a"
  182. is hit, etc.  He just wanted to push the keys and see something
  183. happen.  He likes balloons and "Twinkle, Twinkle Little Star"
  184. was one of his favorite songs.  So this program was
  185. conceived to give him a way to hit any key and see something
  186. happen. He learned surprisingly quickly (and remembered) where the
  187. up and down arrow keys are and the keys that made the color of
  188. balloons he liked (G, B and R). This program has been a very
  189. positive experience for Charles; I hope you find that to be true
  190. for your child as well.
  191.  
  192. As an aside, because his favorite color is green, when the
  193. balloons are made randomly, there will be more green ones than
  194. any other color.
  195.  
  196. ==================================================================
  197.  
  198. PACKAGE CONTENTS:
  199.  
  200. This package contains 3 files: BALLOONS.EXE -- the program.
  201.                                BALLOONS.REG -- the registration form
  202.                                BALLOONS.DOC -- this file.
  203.  
  204. ==================================================================
  205.  
  206. WARRANTY:
  207.  
  208. Users of BALLOONS must accept this disclaimer of warranty:
  209.  
  210. BALLOONS is supplied as is.  The author disclaims all warranties,
  211. expressed or implied, including, without limitation, the
  212. warranties of merchantability and fitness for any purpose.  The
  213. author assumes no liability for damage, direct or consequential,
  214. which may result from the use of BALLOONS.
  215.  
  216. ==================================================================
  217.  
  218. Association of Shareware Professionals - Ombudsman Statement
  219.  
  220.   This program is produced by a member of the Association
  221.   of Shareware Professionals (ASP).  ASP wants to make sure
  222.   that the shareware principle works for you. If you are
  223.   unable to resolve a shareware-related problem with an ASP
  224.   member by contacting the member directly, ASP may be able
  225.   to help. The ASP Ombudsman can help you resolve a dispute
  226.   or problem with an ASP member, but does not provide
  227.   technical support for members' products. Please write to
  228.   the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427
  229.   or send a CompuServe message via CompuServe Mail to ASP
  230.   Ombudsman 70007,3536."
  231.  
  232. ==================================================================
  233.  
  234. DISTRIBUTION OF PROGRAM:
  235.  
  236. You can give a copy of this program to anyone who wants it.  Please
  237. encourage them to register if they find the program useful.
  238.  
  239. ==================================================================
  240.  
  241. REGISTRATION PROCESS AND FEE:
  242.  
  243. I hope your child is enjoying the BALLOONS program.  My two-year old
  244. son, Charles, has a great time with it, and asks to "work on the 'puter"
  245. frequently in order to make balloons and then pop them.
  246.  
  247. This is the point where I'm supposed to ask you to send money if you
  248. like this program.  My husband and I are honest people; I trust that
  249. you are as well.  If, indeed, you value this program and your child's
  250. interest in it, please send the registration form included with this
  251. program (balloons.reg) and the registration fee to:
  252.                             AssistWare
  253.                             Atten:  Balloons Registration
  254.                             P.O. Box 13464
  255.                             Research Triangle Park, NC 27709-3464
  256.                             USA
  257.  
  258. There are two registration options, please pick the one that you prefer:
  259.  
  260. Option 1:
  261. If you send $7.00, we will register you as a user, entitling you to
  262. future upgrades, technical support and information about other programs
  263. for your child.
  264.  
  265. Option 2:
  266. If you send $15.00, you will receive , in addition to the items in
  267. Option 1, above, three other programs:
  268. -- BALLOONS & RAINBOWS - a non-shareware program similar to this program
  269.         but with several advanced features, designed to help your child
  270.         learn colors and color names.  These features include the
  271.         ability to display the names of the balloon colors, the ability
  272.         to allow balloons to be drawn selectively, and other options.
  273. -- A registered version of "DRAWSOME" - a wonderful children's drawing
  274.         program that helps children learn how to interact with the
  275.         computer and a mouse (optional).  The program draws lines with
  276.         a hand as the hand is moved with the arrow-keys or with the
  277.         mouse.  Colors are selectable and various flowers, circles,
  278.         triangles and squares are drawn when certain keys are pressed.
  279. -- A graphical menu which your child can use to select the program with
  280.         which (s)he wishes to play.
  281.  
  282. Please use the registration form included with this program
  283. (balloons.reg).  Just print it and mail it in.  Please remember: if you
  284. are taking advantage of option 2, include the size of diskette which
  285. you use (3.5" or 5.25").
  286.  
  287. Thank you,
  288. Patti
  289.